Release 10.1A: OpenEdge Development:
ADM Reference

bufferCopyDBToRO

Procedure that performs a BUFFER–COPY of a database buffer to a row object buffer. In particular, if an assign–list is used to map individual array elements from the database buffer to the row object buffer, this procedure ensures that the values are copied properly.

Location: query.p

Parameters:

INPUT phRowObj AS HANDLE

Handle to the row object buffer that is to be the target of the BUFFER–COPY.

INPUT phBuffer AS HANDLE

Handle to the database buffer that is to be the source of the BUFFER–COPY.

INPUT pcExcludes AS CHARACTER

Comma-delimited list of fields to be excluded from the BUFFER–COPY.

INPUT pcAssigns AS CHARACTER

Comma-delimited list of field pairs to be individually copied. The field pairs are mappings of fields from the target/source buffers where the field names differ.

Notes: The primary purpose of this procedure is to detect when individual array fields are referenced in the assign–list (pcAssigns) from the database buffer and to ensure that they are copied properly. It is assumed that the database buffer is always the source of the BUFFER–COPY, so that the second field in the assign–list field pair is always where the individual array reference is found (for example, pcAssigns = “ROfld1,DBfld[1]”).